home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 041-050 / amok47 / oberonced / obced.doc < prev    next >
Text File  |  1993-11-04  |  4KB  |  117 lines
  1.  
  2.                             ObCED-Documentation
  3.  
  4. Author: Achim Siebert, Nobileweg 40, 7000 Stuttgart 40.
  5.  
  6. This  program  is  in  the  Public  Domain  (one  of the last ones, maybe -
  7. donations welcome, though).  You may do with it whatever you want to do.  I
  8. would  be  grateful  for  convenient  suggestions  for improvement.  If you
  9. ingeniously change the program then please send me a copy.
  10.  
  11. What it does:
  12.  
  13. ObCED/ObCEDCall  calls  OBERON  and  OLink  out of CygnusEd and shows error
  14. messages.  You don't need AREXX (would be better, though).
  15.  
  16. USAGE: Run ObCED [c][l][e][opt] |[next] |[prev] |[first] |[quit]
  17.        ObCEDCall [c][l][e][opt] |[next] |[prev] |[first] |[quit]
  18.  
  19. Prerequisites for perfect operation of this program:
  20.  
  21. CygnusEd Professional Release 2 loaded.
  22. "OBERON:Fehler-Meldungen" exists (sorry, my brother is still working on the
  23. english version of the OBERON system).
  24. "T:" exists (best place for it: 'RAM:').
  25. Commands "stack" and "path" are in the "C:" directory.
  26. The  file's  name  must  contain the extension ".mod" and correspond to the
  27. name of the module (of course).
  28.  
  29. Files  produced  by  compiler and linker will automatically go to the right
  30. drawer.  You may also use "txt" drawers for the source texts.
  31.  
  32. Memory consumption: nearly 55k.
  33.  
  34. Description of the program's options:
  35.  
  36. c :    start compiler.         \
  37. l :    start linker.            > any combination possible.
  38. e :    start the new program.  /
  39. opt:   asks for compiler, linker and program options.  Default for complier
  40.        and linker : "-md".
  41.        Only possible together with "c", "l" and/or "e".
  42. first: show  the first  error, if existing.  Will be invoked  automatically
  43.        if the compiler creates an error file.
  44. next:  show  the  next  error   (only  possible  if still in the same file,
  45.        otherwise shows the first error).
  46. prev:  show the previous error (corresponding to "next").
  47. quit:  guess what...
  48.  
  49. Without  options the program will be loaded into memory and will wait to be
  50. invoked  by itself, by ObCEDCall or by AREXX.  Starting ObCED again without
  51. an option will remove it from memory.
  52.  
  53. ObCEDCall:   For  those  who don't own AREXX.  This small program sends the
  54. required  option  to the running ObCED.  Usage:  same as ObCED.  Best thing
  55. to  do is to make ObCEDCall resident and call it from a CygnusEd macro.  If
  56. ObCED  is  not  already  in memory, ObCEDCall will try to load it (so ObCED
  57. should  be  found  in the current path - or put it into the C:  directory).
  58. It's function is comparable to that of CygnusEd's "ED".
  59.  
  60.  
  61.                                  Examples:
  62. 1.
  63.  
  64. Call: ObCEDCall cleopt
  65. or:
  66. ObCEDCall -elcopt
  67. or:
  68. ObCEDCall optlec ...
  69.  
  70. Function:   asks  for  compiler  and  linker options, starts OBERON and, if
  71. there are no errors, OLink.  Then it will ask for the new program's options
  72. and starts the executable program with those options.
  73.  
  74. 2.
  75.  
  76. Call: ObCEDCall prev
  77.  
  78. Function:   if there is an error file (...modE) and the module was compiled
  79. before,  then  the previous error will be shown.  If you didn't compile the
  80. file using ObCED, then the first error will be shown, if existing.
  81.  
  82.  
  83.                          Calling ObCED from AREXX
  84.  
  85. RX "address ob_ced; option"
  86.  
  87.    where  "option"  is  the  same  as  in  the ObCED(Call) usage, i.e.  the
  88. examples above will look like this:
  89.  
  90. 1. RX "address ob_ced; cleopt"     or:  RX "address ob_ced; copt;lopt;eopt"
  91. 2. RX "address ob_ced; prev"
  92.  
  93. Of  course  you  may  send  the  option  by  using CygnusEd's command "Send
  94. Dos/ARexx  command..."  as  well,  giving  it  the command "address ob_ced;
  95. option";  and  put  it  to any key by using  a macro.  So you won't have to
  96. call RX explicitly.
  97.  
  98. Watch  out:   Don't send ObCED an option it doesn't know.  You may get what
  99. you  want  (  "address  ob_ced;  nonsense"  for  instance  will  start  the
  100. executable, because there is an "e" in the string!).
  101.  
  102. TIP:   start  CygnusEd  with  the "-keepio" option.  This will speed up the
  103. error  messages  dramatically,  because  CygnusEd  won't  open it's command
  104. window which takes a lot of time.
  105.  
  106.  
  107.                  Changing the compiler and linker defaults
  108.  
  109. Change line 302 of the source ObCED.mod and do a new compilation:
  110.  
  111.    compoptions := "-md "; linkoptions := "-md ";
  112.  
  113. Don't forget the space at the end of the string!
  114.  
  115.  
  116. Spread the program, not the word!!! Achim.
  117.